home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 May / SGI IRIX 6.5 Complementary Applications 2004 May.iso / dist / OpenOffice.idb / usr / OpenOffice / help / en / sbasic.jar / text / sbasic / common / 03120403.xml < prev    next >
Encoding:
Extensible Markup Language  |  2002-01-24  |  2.6 KB  |  41 lines
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>StrComp Function [Runtime]</title><meta name="filename" content="text/sbasic/common/03120403"/><meta name="language" content="en-US"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         p.P1{
  5.                 }
  6.         p.P2{
  7.                 }
  8.         span.T1{
  9.                 font-weight:bold;}
  10.         </style></head><body>
  11.   
  12.   
  13.   <help:to-be-embedded Eid="strcomp" xmlns:help="http://openoffice.org/2000/help">
  14.   <p class="Head1"><help:link Id="66473">StrComp Function [Runtime]</help:link></p>
  15.   <p class="Paragraph">Compares two strings and returns whether the strings are equal, whether one of the strings is an empty string, or whether one string is longer than the other.</p>
  16.   </help:to-be-embedded>
  17.   <p class="Paragraph"><span class="T1">Syntax</span>:</p>
  18.   <p class="Paragraph">StrComp (Text1 As String, Text2 As String[, Compare]) <help:key-word value="StrComp" tag="kw66473_1" xmlns:help="http://openoffice.org/2000/help"/></p>
  19.   <p class="Paragraph"><span class="T1">Return value</span>:</p>
  20.   <p class="Paragraph">Integer</p>
  21.   <p class="Paragraph"><span class="T1">Parameter</span>:</p>
  22.   <p class="Paragraph">Text1: Any string expression to be compared with the one returned after that.</p>
  23.   <p class="Paragraph">Text2: Any string expression to be compared with the one returned before.</p>
  24.   <p class="Paragraph">Compare: This optional parameter sets the comparison method. If Compare = 0 the string comparison is case-sensitive. If Compare = 1 no difference is made between upper and lower case letters.</p>
  25.   <p class="Paragraph">Use this function to compare two strings with each other according to the conventions determined by the argument Compare.</p>
  26.   <p class="Paragraph">The possible return values are -1, 0, 1:</p>
  27.   <p class="P2">Return value</p>
  28.   <p class="Paragraph">-1 : Text1 > Text2 (e.g., "Time" and "Thyme").</p>
  29.   <p class="Paragraph">0 : Both strings are identical (e.g., "Time" and "Time").</p>
  30.   <p class="Paragraph">1 : Text1 < Text2 (e.g., "Thyme" and "Time").</p>
  31.   <p class="Paragraph">Null : One of the strings is an empty string (e.g., "Peter" and "").</p>
  32.   <p class="P2">Example:</p>
  33.   <p class="PropText">Sub ExampleStrComp</p>
  34.   <p class="PropText">Dim iVar As Single</p>
  35.   <p class="PropText">Dim sVar As String</p>
  36.   <p class="PropText">iVar = 123.123</p>
  37.   <p class="PropText">sVar = Str$(iVar)</p>
  38.   <p class="PropText">Msgbox strcomp(sVar , Str$(iVar),1)</p>
  39.   <p class="PropText">end sub</p>
  40.   <p class="PropText"/>
  41.  </body></html>